lcBlockGetBlkRefByTag

Retrieves block references by attribute tag and value.

HANDLE lcBlockGetBlkRefByTag (
   HANDLE hBlock,
   HANDLE hBlockAtt,
   LPCWSTR szTag,
   LPCWSTR szValue,
   BOOL bSelect
);

Parameters

hBlock
	Handle to a block.
hBlockAtt
	Handle to a block which contains attribites definitions. If NULL then function will search in attributes of all blocks.
szTag
	Attribute tag.
szValue
	Attribute value. If NULL or empty string, then function will consider only Tag name.
bSelect
	If false, then function returns a handle to the first found object. If true, then function adds all found objects into selection set.

Return Value

Handle to the first found block reference object.
If objects with specified tag/value is not found, the function returns NULL.